feat(docs): Add Azure Local 2604 features — Simplified Provisioning, SAN deployment, Local Identity GA#45
Merged
kristopherjturner merged 4 commits intomainfrom May 1, 2026
Conversation
…SAN deployment, Local Identity GA
- Add Simplified Machine Provisioning (Preview) section under Phase 02 OS Installation
- 5 task files covering USB media creation, machine prep, Azure provisioning,
monitoring, and Arc verification
- Index page with ISO vs Simplified comparison table
- Integration with azurelocal-ztp community automation project
- Add SAN (Disaggregated) deployment path under Phase 05 Cluster Deployment
- 4 new runbooks: AD/Local Identity × Portal/ARM Template for SAN storage
- SAN index with FC patterns, prerequisites, and S2D vs SAN comparison
- Updated decision trees and deployment matrices across all index pages
- Update Local Identity from Preview to GA
- Remove preview warnings and badges
- Position as fully supported deployment method alongside Active Directory
- Pin Microsoft Learn links to ?view=azloc-2604
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
Updates the Azure Local implementation runbooks to document Azure Local 2604 capabilities—adding SAN (disaggregated) deployment guidance, introducing simplified machine provisioning (preview) OS install flow, and marking Local Identity as GA across relevant pages.
Changes:
- Added a SAN (disaggregated) deployment method with parallel AD and Local Identity portal/ARM runbooks and navigation updates.
- Added a Simplified Machine Provisioning (preview) guide under Phase 02 with 5 task runbooks and updated OS installation decision flow.
- Updated multiple “master reference” links to pin Microsoft Learn content to
?view=azloc-2604and updated Local Identity status/badges to GA.
Reviewed changes
Copilot reviewed 22 out of 22 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/implementation/04-cluster-deployment/phase-05-cluster-deployment/index.mdx | Adds SAN vs S2D method groupings and links; pins master reference to azloc-2604. |
| docs/implementation/04-cluster-deployment/phase-05-cluster-deployment/deployment-methods/san/index.mdx | New SAN deployment overview, prerequisites, FC patterns, and post-deploy steps. |
| docs/implementation/04-cluster-deployment/phase-05-cluster-deployment/deployment-methods/san/category.json | Adds Docusaurus category for SAN deployment docs. |
| docs/implementation/04-cluster-deployment/phase-05-cluster-deployment/deployment-methods/san/active-directory/portal-instructions.mdx | New AD + SAN portal runbook. |
| docs/implementation/04-cluster-deployment/phase-05-cluster-deployment/deployment-methods/san/active-directory/arm-template-instructions.mdx | New AD + SAN ARM template runbook. |
| docs/implementation/04-cluster-deployment/phase-05-cluster-deployment/deployment-methods/san/active-directory/category.json | Adds category grouping for AD SAN runbooks. |
| docs/implementation/04-cluster-deployment/phase-05-cluster-deployment/deployment-methods/san/local-identity/portal-instructions.mdx | New Local Identity + SAN portal runbook. |
| docs/implementation/04-cluster-deployment/phase-05-cluster-deployment/deployment-methods/san/local-identity/arm-template-instructions.mdx | New Local Identity + SAN ARM template runbook. |
| docs/implementation/04-cluster-deployment/phase-05-cluster-deployment/deployment-methods/san/local-identity/category.json | Adds category grouping for Local Identity SAN runbooks. |
| docs/implementation/04-cluster-deployment/phase-05-cluster-deployment/deployment-methods/local-identity/portal-instructions.mdx | Updates Local Identity to GA badge/status and pins Learn links to azloc-2604. |
| docs/implementation/04-cluster-deployment/phase-05-cluster-deployment/deployment-methods/index.mdx | Updates deployment decision tree/matrix to include SAN alongside S2D and removes Local Identity preview callout. |
| docs/implementation/04-cluster-deployment/phase-02-os-installation/index.mdx | Adds ISO vs simplified provisioning decision content, links, and workflow diagrams. |
| docs/implementation/04-cluster-deployment/phase-02-os-installation/simplified-provisioning/category.json | Adds Docusaurus category for simplified provisioning section. |
| docs/implementation/04-cluster-deployment/phase-02-os-installation/simplified-provisioning/index.mdx | New simplified provisioning overview with comparison tables, prerequisites, and workflow. |
| docs/implementation/04-cluster-deployment/phase-02-os-installation/simplified-provisioning/task-01-create-usb-media.mdx | New runbook for creating USB media for simplified provisioning. |
| docs/implementation/04-cluster-deployment/phase-02-os-installation/simplified-provisioning/task-02-prepare-machines.mdx | New runbook for maintenance environment boot + voucher collection. |
| docs/implementation/04-cluster-deployment/phase-02-os-installation/simplified-provisioning/task-03-provision-from-azure.mdx | New runbook for provisioning machines from Azure portal and feature registration. |
| docs/implementation/04-cluster-deployment/phase-02-os-installation/simplified-provisioning/task-04-monitor-progress.mdx | New runbook for monitoring provisioning via Configurator app. |
| docs/implementation/04-cluster-deployment/phase-02-os-installation/simplified-provisioning/task-05-verify-arc.mdx | New runbook for verifying Arc connectivity and “Ready to cluster” status. |
| docs/implementation/04-cluster-deployment/deployment-methods/index.mdx | Updates deployment methods quick reference to include SAN and pins master reference. |
| docs/implementation/04-cluster-deployment/deployment-methods/01-portal-deployment.mdx | Adds SAN portal deployment option links. |
| docs/implementation/04-cluster-deployment/deployment-methods/02-arm-template-deployment.mdx | Adds SAN ARM template deployment option links. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Remove legacy 0.0.1 version entirely - Rename 1.0.0 → 2411 (frozen pre-2604 snapshot) - Current docs become version 2604 (default) - Update docusaurus.config.js: lastVersion, version labels, navbar dropdown - Update .release-please-manifest.json to 2604.0.1 - Add Simplified Provisioning skip callout to Phase 04 Arc Registration The versioning now follows Azure Local's build numbering (2411, 2604, etc.) instead of generic semver, making it clear which Azure Local release each version of the docs corresponds to. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…clusions - Add Defender exclusion cleanup guidance with Remove-MpPreference command - Add factory-default credential warnings linking to Microsoft's official docs - Scope Defender exclusion instructions to narrow, trusted paths only Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updates the azurelocal.github.io documentation to reflect three key features from Azure Local 2604:
1. Simplified Machine Provisioning (Preview)
simplified-provisioning/section under Phase 02 OS Installation2. SAN (Disaggregated) Deployment
san/subfolder under deployment-methods with parallel Active Directory and Local Identity paths3. Local Identity → GA
Additional Changes
?view=azloc-2604Files Changed
Verification
npx docusaurus buildpasses with[SUCCESS]— no broken links, no warnings